RESOURCE NODE COMPASS for Monsters & Memories - quick start
============================================================

A small round radar that sits on top of the game and shows ore, herbs, wood piles and Woodcap
around you. It turns with your character: the top of the circle is the way you face.

It only READS the game's memory. It never changes the game, never presses keys and
never sends anything to the game server. You still do all the walking and gathering.
It keeps itself up to date: it checks its release site for a newer release when it starts
(and every 30 minutes) and installs it by itself, never while you play. Switch that off
in the right-click menu (the "Release" entry at the bottom).
Please read "Use at your own risk" in README.md before using it.


SETUP (once)
------------
Double-click "Setup.bat" in this folder (or just "Resource Nodes.bat": the first
time it runs the setup by itself).
- If Python 3.14 is not on this PC, it asks "Download and install Python 3.14 now?".
  Press Y: it is downloaded from python.org and installed for your Windows user only
  (about 30 MB, no administrator rights needed).
- Then it installs the packages the compass needs (numpy, UnityPy and Pillow; the last
  two are for the zone map) and says "Setup is done".
Rather install Python yourself? Get Python 3.14 from https://www.python.org/downloads/
(NOT 3.15 or newer: too new for the zone map packages; keep the default options) and
then run Setup.bat.


EVERY TIME
----------
1. Start Monsters & Memories and log in to your character.
2. Set the game to "Windowed" or "Borderless windowed" in its video options.
   (Nothing can be drawn on top of exclusive fullscreen.)
3. Double-click "Resource Nodes.bat". The compass appears near the top right.


USING IT
--------
- Drag it with the left mouse button to move it. It remembers where you put it.
- Mouse wheel = zoom in / out (range). 150 is a good range for nodes; see README.md for why.
  Keep zooming out and it becomes a map of the whole zone with you as an arrow on it.
  Handy when you are lost. The N on the rim is north.
- Middle-click the disc (or press M while it is clicked) = lock north up, so the map
  holds still and your arrow turns instead. Middle-click again to let it turn with you.
- Hover over a dot to see what it is, how far, which way to turn, and the skill it needs.
- Right-click for the menu: what to show, which skills / node types, range, beep,
  size, transparency, quit.
- Esc (while the compass is clicked) or right-click > Quit closes it.

Dots:   orange = mining   green = herbs   brown = wood   purple = other
        big dot with a white ring = Rich node
        hollow ring = your skill is too low (or not trained)
        faint dot = a node was seen there before, not confirmed up right now
        a spot you (or anyone) just harvested stays hidden for 15 minutes
X's:    red = monster   violet (bigger) = named monster   yellow = your target
        blue = your pet   turquoise = player
        grey = friendly NPC or someone else's pet (off by default)
Corpses: pink ring = YOUR corpse (always shown, on the rim if far; the text
         under the disc says how far)   grey square = other players' corpses
        (your target always shows, even with monsters off: corpses and players too)
Gold diamond = a jackal pup (creatures to gather from; add more in the settings file)
Yellow triangle with a name = a way into that zone. The compass learns these each time
         you zone (filled = you left through here, hollow = you arrived here from there),
         so it knows more the more you travel. Hover one for distance and direction.
The arrow in the middle is you.
Background: the zone map (walls and floors of your level; other levels faint; water blue). The
         first visit to a zone builds it in the background, up to a minute. If the shapes
         confuse you when zooming, choose "Map & window" > "Map: land and water only" in the menu.


SOMETHING WRONG?
----------------
- Nothing appears: double-click "Resource Nodes (show errors).bat" and read the message.
- It freezes, crashes or acts strangely: send the file logs\errors.txt (and the .log files
  in logs\maps) to whoever gave you the compass.
- It says "waiting for your character...": you are not in the world yet (still on the
  character screen or zoning). It picks up by itself, also after a disconnect or a
  game restart (allow up to a minute after you are back in the world).
- It says "game updated - a fix installs itself once out": a game patch changed things the
  compass relies on. Nothing to do: once a fixed release is out, it installs by itself.
  (With self-update off: download the newest one from https://node-compass-releases.pages.dev)
- It says "waiting for the game to start...": start the game; it connects by itself.

More detail, including every menu option, is in README.md.
